home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Atari Mega Archive 2
/
Atari Mega Archive CD - Volume 2.iso
/
8bit
/
cislib_a
/
extbas.doc
< prev
next >
Wrap
Text File
|
1995-04-22
|
11KB
|
418 lines
PART I. INTRODUCTION
EXTENDED BASIC is a programmer's aid package which adds 12 useful
commands to BASIC. The commands are Direct Mode commands and function as
if they were included within the BASIC Cartridge themselves. Various
types of commands are DOS related, editing and reference.
SYSTEM REQUIREMENTS
ATARI 400/800
32K Ram
ATARI 810 Disk Drive or Equivalent
ATARI BASIC Language Cartridge
Optional Accessories
System Printer
LOADING EXTENDED BASIC.
1. Turn the computer off.
2. Insert the Basic Cartridge in the left slot.
3. Turn on your disk drive.
4. When the BUSY light goes out, open the disk drive door and insert the
EXTENDED BASIC diskette with the label in the lower right-hand corner
nearest you. (use disk drive one if you have more than one drive.)
5. Turn on your computer and your TV set. The program will load in memory
and start automatically.
6. After the system boots the top line on the screen should say:
Extended Basic 1.0
You may now edit and run Basic programs normally.
PART II. USING EXTENDED BASIC
CORRECT METHOD OF INPUT.
All Extended Basic commands must be entered in Direct Mode and there
can be only one command per line.
EXAMPLE: 1) DELETE 10,100
2) DELETE 10,100:LIST 10,100
3) LIST 10,100:DELETE 10,100
The correct method of entering the command is Example 1. In example
2 the DELETE command will be executed but the LIST command will be
ignored. In example 3 Basic will return a syntax error and neither
command will be executed.
COMMANDS
The following commands comprise the Extended Basic program:
EDITING DOS UTILITIES REFERENCE CONTROL
RENUMBER DIRECTORY QREF @D
DELETE LOCK XREF @E
REPLACE UNLOCK SIZE @X
MARGIN RENAME
ERASE
EDITING IN EXTENDED BASIC.
All direct mode input to BASIC is converted from lower-case to
upper-case and inverse to normal. The only text that is not converted is
the text within double quotes.
PART III. EDITING COMMANDS
RENUMBER
The Renumber command takes the program text in memory and renumbers
it according to the parameters entered with the command. Extended Basic
will renumber the program even if the program contains variable branching
and unreferenced line numbers. Variable branching and unreferenced line
numbers are displayed during the renumber process.
FORMAT: RENUMBER [strt][,new][,inc][,output]
Short hand for RENUMBER is REN.
PARAMETER EXPLANATION
strt Starting line number, the default is the first line of
the program.
new New line number, the default is the starting line number.
inc Increment between line numbers, the default is 10.
output Device which the error flags will be printed, valid
output devices are E:,S:,P:. The default is E:
EXAMPLES:
RENUMBER 10,,20,"P:"
The program will be renumbered starting at 10 with increments of 20,
the error flags will go the the system printer.
REN.,,5
If the first program line was 100 then the program will be renumbers
starting at 100 with increments of 5, the error flags will go to the
screen.
RENUM.,1000,,"E:"
the program will now start at 1000 with increments of 10, the error
flags will go to the screen.
RENUMBER ERROR FLAGS
The error flags are printed whenever a variable branch or a
unreferenced line number is encountered. the types of error flags are as
follows:
V/1000 The V indicates a variable branch and 1000 is the
line number it occurs in.
#/40000/1000 The # indicates a unreferenced line number, the 40000
is the unknown line number and the 1000 is the line
number it occurs in.
DELETE
The DELETE command will delete all line numbers within the two
parameters.
FORMAT: DELETE strt [,END]
Short Hand: DEL.
PARAMETER EXPLANATION
strt Starting line number.
end Ending line number, the default is the starting line
number.
EXAMPLES:
DELETE 10,100
Lines 10 thru 100 are deleted.
DEL.20
Line 20 is deleted.
REPLACE
The REPLACE command will replace a variable name with a new variable
name.
FORMAT: REPLACE "old-var","new-var"
Short Hand: REPL.
PARAMETER EXPLANATION
old-var Old Variable Name, this must be a valid variable name.
new-var New Variable Name, this must be a valid variable name and
unique.
If old-var is a string then new-var must be a string. The same
applies to array names. The format of the variable name is described in
the BASIC REFERENCE MANUAL.
ERRORS RETURNED BY REPLACE
ERROR CODE EXPLANATION
22 Old Variable Name not found.
23 New Variable Name already exists.
24 Invalid Variable name.
EXAMPLES:
REPLACE "A$","B$"
All occurences of A$ is replaces with B$ and A$ is removed from the
Variable Name Table.
REPL."ARRAY(","DARRY("
All occurences of ARRAY( is replaces with DARRAY( and ARRAY( is
removed from the Variable Name Table.
REPLA."COUNTER","LCOUNT"
All occurences of COUNTER is replaces with LCOUNT and COUNTER is
removed from the Variable Name Table.
MARGIN
The MARGIN COMMAND automatically sets the left and right margins for
you.
FORMAT: MARGIN [left][,right]
Short Hand: MAR.
PARAMETER EXPLANATION
left Left Margin, this must be greater than or equal to 0 and
less then 40. The default is 2.
right Right Margin, The must be greater than or equal to 0 and
less then 40. The default is 39.
EXAMPLES:
MAR.0,39
The margins are set to the extreme left and right edges of the
screen.
MAR.
The margins are set as they are after System Reset.
PART IV. DOS UTILITIES.
Five Dos commands are included in the Extended Basic program. They
will allow the programmer limited file maintenence.
************* NOTE *****************
The DOS command has been disabled for the reasons of giving the
programmer the most free memory, and that DUP will overwrite Extended
Basic's memory. If you need to go to DOS the following commands will get
you there.
@X
DOS
DIRECTORY
The DIRECTORY COMMAND will print the Directory of a Disk to the
output device.
FORMAT: DIRECTORY [drive#][,output]
Short Hand: DI.
PARAMETER EXPLANATION
drive# Disk Drive number the contains the disk you wish the
directory of, the default is drive 1.
output Device in which the printed output is to go valid devices
are E:,S:,P:. The default device is E:.
EXAMPLES:
DIR.
The directory of drive #1 is displayed on the screen.
DIR.,"p:"
The directory of drive #1 is printed on the system printer.
DIRECTORY 2
The directory of drive #2 is displayed on the screen.
LOCK, UNLOCK AND ERASE
FORMAT: LOCK"D[n]:FILESPEC[.EXT]"
This command will lock the selected file, or files that meet
wildcard specs.
FORMAT: UNLOCK"D[n]:FILESPEC[.EXT]"
This command will unlock the selected file, or files that meet
wildcard specs.
FORMAT: ERASE"D[n]:FILESPEC[.EXT]"
This command will erase the selected file, or files that meet
wildcard specs.
PARAMETER EXPLANATION
n Drive number.
FILESPEC Filename & optional Extension.
RENAME
This command will rename a file with a new file name.
FORMAT: RE